Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 11 - Renderer Objects / Renderer Objects Reference

Renderer Objects Routines / Creating and Managing Renderers

Q3Renderer_Flush

You can use the Q3Renderer_Flush function to flush any image buffers maintained internally by a renderer.

TQ3Status Q3Renderer_Flush (
TQ3RendererObject renderer, 
TQ3ViewObject view);

renderer

A renderer.

view

A view.

DESCRIPTION

The Q3Renderer_Flush function flushes any image buffers maintained internally by the renderer specified by the renderer parameter when drawing in the view specified by the view parameter. This function is useful only when the draw context associated with the specified view is in single-buffering mode. In that case, the renderer might need to allocate a temporary buffer to hold data before it can render an image. In general, the user will not see any of the image until your application calls Q3View_EndRendering. You can, however, call the Q3Renderer_Flush function inside the rendering loop to force the renderer to draw objects as they are submitted for drawing.

SPECIAL CONSIDERATIONS

Calling the Q3Renderer_Flush function can adversely affect the performance of your application. You should call this function only when you need to force the renderer to draw objects as they are submitted for drawing.